{"note":"OpenAPI conversion -- returning structured metadata","name":"gisgraphy-com","description":"Gisgraphy webservices","version":"4.0.0","base_url":"http://free.gisgraphy.com/","endpoints":6,"raw":"@lap v0.3\n# Machine-readable API spec. Each @endpoint block is one API call.\n@api Gisgraphy webservices\n@base http://free.gisgraphy.com/\n@version 4.0.0\n@auth ApiKey api_key in query\n@common_fields {format: any # The output format., callback: any # The callback method name (optional), use to wrap the content into a (alphanumeric) Javascript method. Works only for script output formats (JSON, PHP, Ruby, Python), indent: any # indents the results. Possible values are true or false (or on when used with the rest service. If you use a checkbox in a web form, to indent the results, the value will be 'on' or 'off', so for a simple use : the value of indent can be 'true' or 'on'}\n@endpoints 6\n@toc geocoding(1), reversegeocoding(1), street(1), geoloc(1), fulltext(1), addressparser(1)\n\n@group geocoding\n@endpoint GET /geocoding/geocode\n@desc Geocode an address\n@required {address: any # A postal address, structured or not, a street, a city, a postal code, a country, or a combination.}\n@optional {country: any # The country where the place/address is. It is used to determine the postal address format and to improve performance. It will probably be optional in next version to ease the usability. The value must be the ISO 3166 Alpha 2 code of the country., postal: any # Whether the given address is a postal address. default to false. In other words, if the address follow the specification or if it is a well-formed address as it was written on an envelope. This parameter will enable the parsing of the address by the address parser before geocoding, this way, the relevance will be better because because if parsing is successful, we will know the meaning of each word. Note that you can also specify each field if you already know them., from: any # The first pagination index. Numbered from 1. If the number is < 1 or not specified, it will be set to the default value : 1, to: any # The last pagination index. if < 1 or not specified, it will be set to startindex + 10. Max = 10 (can be changed)}\n@returns(200) Sucessfully processed\n@errors {401: Need auth. The API key parameter is missing or wrong, or doesn't correspond to any subscriptions, 403: Unhauthorize (auth will change nothing).Your IP is not allowed., 412: Missing parameter. Some parameters required for the webservices ar missing, please consult documentation, 429: Too many requests. You exceed the authorized rate, 500: Internal error}\n\n@endgroup\n\n@group reversegeocoding\n@endpoint GET /reversegeocoding/reversegeocode\n@desc Reverse geocode an address\n@required {lat: any # The latitude (north-south) for the location point to search around. The value is a floating number, between -90 and +90. It uses GPS coordinates, lng: any # TThe longitude (east-West) for the location point to search around. The value is a floating number between -180 and +180. It uses GPS coordinates.}\n@optional {from: any # The first pagination index. Numbered from 1. If the number is < 1 or not specified, it will be set to the default value : 1, to: any # The last pagination index. if < 1 or not specified, it will be set to startindex + 10. Max = 10 (can be changed)}\n@returns(200) Sucessfully processed\n@errors {401: Need auth. The API key parameter is missing or wrong, or doesn't correspond to any subscriptions, 403: Unhauthorize (auth will change nothing).Your IP is not allowed., 412: Missing parameter. Some parameters required for the webservices ar missing, please consult documentation, 429: Too many requests. You exceed the authorized rate, 500: Internal error}\n\n@endgroup\n\n@group street\n@endpoint GET /street/find\n@desc Geocode an address\n@required {lat: any # The latitude (north-south) for the location point to search around. The value is a floating number, between -90 and +90. It uses GPS coordinates, lng: any # TThe longitude (east-West) for the location point to search around. The value is a floating number between -180 and +180. It uses GPS coordinates.}\n@optional {radius: any # distance from the location point in meters we'd like to search around. The value is a number > 0 if it is not specify or incorrect., oneway: any # whether the street should be a oneWay street (optional) : limit the search to the street that are one way street. If you use a checkbox in a form to indent the results, the value will be 'on' or 'off', so to simplify the use : the value for the web service can be 'true' or 'on', distance: any # Whether (or not) we want the distance field to be output. This option is useful to improve the performance if we don't care about the distance (e.g : we search for name). Of course, the results won't be sorted by distance. If you use a checkbox in a form to indent the results, the value will be 'on' or 'off', so to simplify the use : the value for the web service can be 'true' or 'on', streettype: any # filter search with a stret type, from: any # The first pagination index. Numbered from 1. If the number is < 1 or not specified, it will be set to the default value : 1, to: any # The last pagination index. if < 1 or not specified, it will be set to startindex + 10. Max = 10 (can be changed)}\n@returns(200) Sucessfully processed\n@errors {401: Need auth. The API key parameter is missing or wrong, or doesn't correspond to any subscriptions, 403: Unhauthorize (auth will change nothing).Your IP is not allowed., 412: Missing parameter. Some parameters required for the webservices ar missing, please consult documentation, 429: Too many requests. You exceed the authorized rate, 500: Internal error}\n\n@endgroup\n\n@group geoloc\n@endpoint GET /geoloc/search\n@desc Geocode an address\n@required {lat: any # The latitude (north-south) for the location point to search around. The value is a floating number, between -90 and +90. It uses GPS coordinates, lng: any # TThe longitude (east-West) for the location point to search around. The value is a floating number between -180 and +180. It uses GPS coordinates.}\n@optional {radius: any # distance from the location point in meters we'd like to search around. The value is a number > 0 if it is not specify or incorrect., distance: any # Whether (or not) we want the distance field to be output. This option is useful to improve the performance if we don't care about the distance (e.g : we search for name). Of course, the results won't be sorted by distance. If you use a checkbox in a form to indent the results, the value will be 'on' or 'off', so to simplify the use : the value for the web service can be 'true' or 'on', placetype: any # filter search for a given placetype, from: any # The first pagination index. Numbered from 1. If the number is < 1 or not specified, it will be set to the default value : 1, to: any # The last pagination index. if < 1 or not specified, it will be set to startindex + 10. Max = 10 (can be changed)}\n@returns(200) Sucessfully processed\n@errors {401: Need auth. The API key parameter is missing or wrong, or doesn't correspond to any subscriptions, 403: Unhauthorize (auth will change nothing).Your IP is not allowed., 412: Missing parameter. Some parameters required for the webservices ar missing, please consult documentation, 429: Too many requests. You exceed the authorized rate, 500: Internal error}\n\n@endgroup\n\n@group fulltext\n@endpoint GET /fulltext/search\n@desc search for places by text around a GPS point\n@required {q: any # The searched text : The text for the query can be a zip code, a string or one or more strings, allwordsrequired: any # Whether the fulltext engine should considers all the words specified as required. Defaults to false (since v 4.0). possible values are true|false (or 'on' when used with the rest service)}\n@optional {spellchecking: any # The spellchecking (optional) : whether some suggestions should be provided if no results are found, lat: any # The latitude (north-south) for the location point to search around. The value is a floating number, between -90 and +90. It uses GPS coordinates, lng: any # TThe longitude (east-West) for the location point to search around. The value is a floating number between -180 and +180. It uses GPS coordinates., radius: any # distance from the location point in meters we'd like to search around. The value is a number > 0 if it is not specify or incorrect., suggest: any # If this parameter is set then it will search in part of the names of the street, place,.... It allow you to do auto completion auto suggestion. See the Gisgraphy leaflet plugin for more details. The JSON format will be forced if this parameter is true. See auto completion / suggestions engine for more details, style: any # The output style verbosity (optional) : Determines the output verbosity. 4 styles are available, country: any # limit the search to the specified ISO 3166 country code. Default : search in all countries, lang: any # The language code (optional) : The iso 639 Alpha2 or alpha3 Language Code. Some properties such as the AlternateName AdmNames and countryname belong to a certain language code. The language parameter can limit the output of those fields to a certain language (it only apply when style parameter='style') : If the language code does not exists or is not specified, properties with all the languages are retrieved If it exists, the properties with the specified language code, are retrieved, from: any # The first pagination index. Numbered from 1. If the number is < 1 or not specified, it will be set to the default value : 1, to: any # The last pagination index. if < 1 or not specified, it will be set to startindex + 10. Max = 10 (can be changed)}\n@returns(200) Sucessfully processed\n@errors {401: Need auth. The API key parameter is missing or wrong, or doesn't correspond to any subscriptions, 403: Unhauthorize (auth will change nothing).Your IP is not allowed., 412: Missing parameter. Some parameters required for the webservices ar missing, please consult documentation, 429: Too many requests. You exceed the authorized rate, 500: Internal error}\n\n@endgroup\n\n@group addressparser\n@endpoint GET /addressparser/parse\n@desc split a raw address into several parts\n@required {address: any # A postal address.}\n@optional {country: any # The ISO 3166 Alpha 2 code of the country., standardize: any # Whether the address should be standardized after parsing, the value will be 'on' or 'off', so for a simple use : the value of indent can be 'true' or 'on', geocode: any # UNUSED YET. Whether the address should be geocoded after parsing, the value will be 'on' or 'off', so for a simple use : the value of indent can be 'true' or 'on'}\n@returns(200) Sucessfully processed\n@errors {401: Need auth. The API key parameter is missing or wrong, or doesn't correspond to any subscriptions, 403: Unhauthorize (auth will change nothing).Your IP is not allowed., 412: Missing parameter. Some parameters required for the webservices ar missing, please consult documentation, 429: Too many requests. You exceed the authorized rate, 500: Internal error}\n\n@endgroup\n\n@end\n"}