# Google Maps

## GET /google-maps/v1/geocode

> Use Google Maps API to turn an address into geo coordinates

```json
{"openapi":"3.1.0","info":{"title":"auor.io","version":"1.0.0"},"servers":[{"url":"https://api.auor.io","description":"auor.io (Oreo) Production server"}],"paths":{"/google-maps/v1/geocode":{"get":{"operationId":"googleMapsGeocodeV1","summary":"Use Google Maps API to turn an address into geo coordinates","tags":["Google Maps"],"parameters":[{"name":"address","in":"query","description":"The address to geodode. Specify addresses in accordance with the format used by the national postal service of the country concerned.","required":true,"schema":{"type":"string"}},{"name":"Accept","in":"header","description":"The content-type to respond with","required":false,"schema":{"type":"string","enum":["application/json","application/xml"]}},{"name":"Accept-Language","in":"header","description":"The language to return the results in","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"./schemas/google-maps/v1/geocode/output.json"}},"application/xml":{"schema":{"$ref":"./schemas/google-maps/v1/geocode/output.json"}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidationError"}}}},"402":{"description":"Payment required","content":{"application/json":{}}}}}}},"components":{"schemas":{"ValidationError":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"string"}}},"required":["errors"]}}}}
```

## GET /google-maps/v1/search/basic

> Use the Google Maps API to search for places with a query, returning basic details

```json
{"openapi":"3.1.0","info":{"title":"auor.io","version":"1.0.0"},"servers":[{"url":"https://api.auor.io","description":"auor.io (Oreo) Production server"}],"paths":{"/google-maps/v1/search/basic":{"get":{"operationId":"googleMapsSearchBasicV1","summary":"Use the Google Maps API to search for places with a query, returning basic details","tags":["Google Maps"],"parameters":[{"name":"query","in":"query","description":"The search query used to search for a place","required":true,"schema":{"type":"string"}},{"name":"pageSize","in":"query","description":"The amount of results to return per page","required":false,"schema":{"type":"integer","minimum":1,"maximum":20}},{"name":"pageToken","in":"query","description":"If another page is available, this token signifies the start of the next page.","required":false,"schema":{"type":"string"}},{"name":"Accept-Language","in":"header","description":"The language to return the results in","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"./schemas/google-maps/v1/search/basic/output.json"}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidationError"}}}},"402":{"description":"Payment required","content":{"application/json":{}}}}}}},"components":{"schemas":{"ValidationError":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"string"}}},"required":["errors"]}}}}
```

## GET /google-maps/v1/search/full

> Use the Google Maps API to search for places with a query, returning all available details

```json
{"openapi":"3.1.0","info":{"title":"auor.io","version":"1.0.0"},"servers":[{"url":"https://api.auor.io","description":"auor.io (Oreo) Production server"}],"paths":{"/google-maps/v1/search/full":{"get":{"operationId":"googleMapsSearchFullV1","summary":"Use the Google Maps API to search for places with a query, returning all available details","tags":["Google Maps"],"parameters":[{"name":"query","in":"query","description":"The search query used to search for a place","required":true,"schema":{"type":"string"}},{"name":"pageSize","in":"query","description":"The amount of results to return per page","required":false,"schema":{"type":"integer","minimum":1,"maximum":20}},{"name":"pageToken","in":"query","description":"If another page is available, this token signifies the start of the next page.","required":false,"schema":{"type":"string"}},{"name":"Accept-Language","in":"header","description":"The language to return the results in","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"./schemas/google-maps/v1/search/full/output.json"}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidationError"}}}},"402":{"description":"Payment required","content":{"application/json":{}}}}}}},"components":{"schemas":{"ValidationError":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"string"}}},"required":["errors"]}}}}
```

## GET /google-maps/v1/details/basic

> Use the Google Maps API to get basic details about a place

```json
{"openapi":"3.1.0","info":{"title":"auor.io","version":"1.0.0"},"servers":[{"url":"https://api.auor.io","description":"auor.io (Oreo) Production server"}],"paths":{"/google-maps/v1/details/basic":{"get":{"operationId":"googleMapsDetailsBasicV1","summary":"Use the Google Maps API to get basic details about a place","tags":["Google Maps"],"parameters":[{"name":"placeId","in":"query","description":"The unique identifier of a place, obtained via the /google-maps/v1/search endpoint.","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"./schemas/google-maps/v1/details/basic/output.json"}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidationError"}}}},"402":{"description":"Payment required","content":{"application/json":{}}}}}}},"components":{"schemas":{"ValidationError":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"string"}}},"required":["errors"]}}}}
```

## GET /google-maps/v1/details/full

> Use the Google Maps API to get all available details about a place

```json
{"openapi":"3.1.0","info":{"title":"auor.io","version":"1.0.0"},"servers":[{"url":"https://api.auor.io","description":"auor.io (Oreo) Production server"}],"paths":{"/google-maps/v1/details/full":{"get":{"operationId":"googleMapsDetailsFullV1","summary":"Use the Google Maps API to get all available details about a place","tags":["Google Maps"],"parameters":[{"name":"placeId","in":"query","description":"The unique identifier of a place, obtained via the /google-maps/v1/search endpoint.","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"./schemas/google-maps/v1/details/full/output.json"}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidationError"}}}},"402":{"description":"Payment required","content":{"application/json":{}}}}}}},"components":{"schemas":{"ValidationError":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"string"}}},"required":["errors"]}}}}
```