Wiki Markup |
---|
{toc} h2. Description Returns location-based look-up data based on the rtype (Region Type) parameter; rtype options are: *bcr*, *country*, *subnational1*, and *subnational2*. Non-parameterized *list* URIs - lists all records for a specific rtype, *list* plus sub-category parameter URIs - lists those records matching the sub-category parameter, *find* URIs - search for matching records in the primary name field on whole word or partial word stubs passed visa the *match* parameter. This is part of the [eBird version 1.1 API|eBird API 1.1]. h2. URL *Base URL* [http://ebird.org/ws1.1/ref/location] *Examples* Minimal *list*: [http://ebird.org/ws1.1/ref/location/list?rtype=bcr] [http://ebird.org/ws1.1/ref/location/list?rtype=country] [http://ebird.org/ws1.1/ref/location/list?rtype=subnational1] [http://ebird.org/ws1.1/ref/location/list?rtype=subnational2] Minimal *find*: [http://ebird.org/ws1.1/ref/location/find?rtype=bcr&match=north] [http://ebird.org/ws1.1/ref/location/find?rtype=country&match=stan] [http://ebird.org/ws1.1/ref/location/find?rtype=subnational1&match=new] [http://ebird.org/ws1.1/ref/location/find?rtype=subnational2&match=west] Fully specified *list*: [http://ebird.org/ws1.1/ref/location/list?rtype=bcr&fmt=csv] [http://ebird.org/ws1.1/ref/location/list?rtype=bcr&fmt=xml] [http://ebird.org/ws1.1/ref/location/list?rtype=country&fmt=csv] [http://ebird.org/ws1.1/ref/taxa/ebird?cat=species&fmt=xml&locale=en_US]/location/list?rtype=country&fmt=xml] [http://ebird.org/ws1.1/ref/location/list?rtype=subnational1&fmt=csv] [http://ebird.org/ws1.1/ref/location/list?rtype=subnational1&fmt=xml] [http://ebird.org/ws1.1/ref/location/list?rtype=subnational1&countryCode=AD] [http://ebird.org/ws1.1/ref/location/list?rtype=subnational1&countryCode=JP&fmt=csv] [http://ebird.org/ws1.1/ref/location/list?rtype=subnational1&countryCode=ZW&fmt=xml] [http://ebird.org/ws1.1/ref/location/list?rtype=subnational2&fmt=csv] [http://ebird.org/ws1.1/ref/location/list?rtype=subnational2&fmt=xml] [http://ebird.org/ws1.1/ref/location/list?rtype=subnational2&countryCode=US] [http://ebird.org/ws1.1/ref/location/list?rtype=subnational2&countryCode=CA&fmt=csv] [http://ebird.org/ws1.1/ref/location/list?rtype=subnational2&countryCode=NZ&fmt=xml] [http://ebird.org/ws1.1/ref/location/list?rtype=subnational2&subnational1Code=GB-ENG] [http://ebird.org/ws1.1/ref/location/list?rtype=subnational2&subnational1Code=CA-AB&fmt=csv] [http://ebird.org/ws1.1/ref/location/list?rtype=subnational2&subnational1Code=nz-can&fmt=xml] Fully specified *find*: [http://ebird.org/ws1.1/ref/location/find?rtype=bcr&match=south&fmt=csv] [http://ebird.org/ws1.1/ref/location/find?rtype=bcr&match=west&fmt=xml] [http://ebird.org/ws1.1/ref/location/find?rtype=country&match=united&fmt=csv] [http://ebird.org/ws1.1/ref/location/find?rtype=country&match=republic&fmt=xml] [http://ebird.org/ws1.1/ref/location/find?rtype=subnational1&match=west&fmt=csv] [http://ebird.org/ws1.1/ref/location/find?rtype=subnational1&match=south&fmt=xml] [http://ebird.org/ws1.1/ref/location/find?rtype=subnational2&match=west&fmt=csv] [http://ebird.org/ws1.1/ref/location/find?rtype=subnational2&match=south&fmt=xml] h2. Parameter Descriptions || Parameter Name || Required || Default || Value Options || Example Value || Description || | cat | no | species | domestic,form,hybrid,intergrade,issf,slash,species,spuh | hybrid | For more info about the meaning of species categories, see [http://ebird.org/content/ebird/about/ebird-taxonomy] | | locale | no | en_US | fr_CA,es_MX,es_PR,ht_HT,fr,fr_HT,es_CU,es_PA,es_DO,en_NZ,es,es_CL | fr_CA | The locale for the taxon common name | | fmt \\ | no \\ | csv \\ | xml,csv \\ | xml \\ | | h3. Resources The human readable version of the current eBird taxonomy can also be downloaded [here|http://ebird.org/content/ebird/about/ebird-taxonomy]. h2. Result Fields || *Field (XML)* || *Description* || | sci-name | Scientific name | | com-name | Common name | | taxon-id | Taxonomic Concept identifier, note this is currently in test | h3. Example Responses h4. CSV {noformat} Rhea americana,Greater Rhea,TC000004 Rhea pennata,Lesser Rhea, TC000005 {noformat} h4. XML {noformat} <response> <header> <locale country="" language="en"/> <timestamp> 2009-07-08T10:39:42.150-04:00 </timestamp> <criteria> <locale country="" language="en"/> <cat> species </cat> <fmt> xml </fmt> </criteria> </header> <result> <taxa> <com-name> Greater Rhea </com-name> <sci-name> Rhea americana </sci-name> <taxon-id> TC00000004 </taxon-id> </taxa> <taxa> <com-name> Lesser Rhea </com-name> <sci-name> Rhea pennata </sci-name> <taxon-id> TC00000005 </taxon-id> </taxa> </response> {noformat} h2. Caching Information For details on caching of results by our servers, see [eBird-1.1-CacheInformation|eBird-1.1-CacheInformation] {import:eBird-footer} |
Page History
Overview
Content Tools