Otomatik tamamlama (yeni) HTTP POST isteklerini kullanır. Parametreleri istek gövdesinde veya üstbilgilerde HTTP POST isteğinin bir parçası olarak iletin. Bunun aksine, eski API'lerde URL parametrelerini bir HTTP GET isteği kullanarak iletirsiniz.
Autocomplete (Yeni), kimlik doğrulama mekanizması olarak hem API anahtarlarını hem de OAuth jetonlarını destekler.
Autocomplete (New) özelliğinde yalnızca JSON yanıt biçimi desteklenir.
Aşağıdaki tabloda, Otomatik Yer Tamamlama (Eski) ve Sorgu Otomatik Tamamlama (Eski) hizmetlerinde bulunan ve Otomatik Tamamlama (Yeni) için yeniden adlandırılan veya değiştirilen ya da artık desteklenmeyen parametreler listelenmektedir.
Geçerli parametre
Yeni parametre
Notlar
components
includedRegionCodes
language
languageCode
location
locationBias
ipbias
Hem locationBias hem de locationRestriction parametresini atlarsanız API varsayılan olarak IP önyargısını kullanır.
offset
inputOffset
radius
locationBias veya locationRestriction
region
regionCode
stricbounds
locationRestriction
sessiontoken
sessionToken
types
includedPrimaryTypes
Örnek istek
Aşağıdaki örnek GET isteğinde Yer Otomatik Tamamlama (Eski) kullanılır. Bu örnekte, establishment türünde olan ve "Amoeba" adlı yerler hakkında bilgi içeren bir JSON yanıtı istiyorsunuz ve tüm parametreleri URL parametreleri olarak iletiyorsunuz:
curl -L -X GET 'https://maps.googleapis.com/maps/api/place/autocomplete/json?input=amoeba&types=establishment&location=37.76999%2C-122.44696&radius=500&key=YOUR_API_KEY'
Otomatik Tamamlama (Yeni) ile bir POST isteği gönderir ve tüm parametreleri JSON istek gövdesinde veya POST isteğinin bir parçası olarak başlıklarda iletirsiniz.
Alan maskeleri, Otomatik Tamamlama (Yeni) istekleri için gerekli değildir ancak yanıttaki belirli sonuçları filtrelemek için kullanılabilir. Örneğin, aşağıdaki istekte alan maskesi kullanıldığından yanıtta yalnızca önerinin suggestions.placePrediction.text kısmı yer alıyor:
[[["Anlaması kolay","easyToUnderstand","thumb-up"],["Sorunumu çözdü","solvedMyProblem","thumb-up"],["Diğer","otherUp","thumb-up"]],[["İhtiyacım olan bilgiler yok","missingTheInformationINeed","thumb-down"],["Çok karmaşık / çok fazla adım var","tooComplicatedTooManySteps","thumb-down"],["Güncel değil","outOfDate","thumb-down"],["Çeviri sorunu","translationIssue","thumb-down"],["Örnek veya kod sorunu","samplesCodeIssue","thumb-down"],["Diğer","otherDown","thumb-down"]],["Son güncelleme tarihi: 2025-08-29 UTC."],[],[],null,["# Migrate to Autocomplete (New)\n\n**European Economic Area (EEA) developers** If your billing address is in the European Economic Area, effective on 8 July 2025, the [Google Maps Platform EEA Terms of Service](https://cloud.google.com/terms/maps-platform/eea) will apply to your use of the Services. Functionality varies by region. [Learn more](/maps/comms/eea/faq).\n\nIntroduction\n------------\n\nPlaces API supports the\n[Place Autocomplete (Legacy)](/maps/documentation/places/web-service/autocomplete)\nand [Query Autocomplete (Legacy)](/maps/documentation/places/web-service/query) APIs.\nIf you are familiar with these APIs, Autocomplete (New) makes the following changes:\n\n- Autocomplete (New) uses HTTP POST requests. Pass parameters in the request body or in headers as part of an HTTP POST request. In contrast, with the legacy APIs, you pass URL parameters using an HTTP GET request.\n- Autocomplete (New) supports both [API keys](/maps/documentation/places/web-service/get-api-key) and [OAuth](/maps/documentation/places/web-service/oauth-token) tokens as the authentication mechanism.\n- Only JSON is supported as a response format in Autocomplete (New).\n\nThe following table lists parameters in Place Autocomplete (Legacy) and Query Autocomplete (Legacy) that have been renamed or modified for Autocomplete (New), or parameters that are no longer supported.\n\n| Current parameter | New parameter | Notes |\n|-------------------|-----------------------------------------|-----------------------------------------------------------------------------------------------------|\n| `components` | `includedRegionCodes` | |\n| `language` | `languageCode` | |\n| `location` | `locationBias` | |\n| `ipbias` | | If you omit both `locationBias` and `locationRestriction`, then the API uses IP biasing by default. |\n| `offset` | `inputOffset` | |\n| `radius` | `locationBias` or `locationRestriction` | |\n| `region` | `regionCode` | |\n| `stricbounds` | `locationRestriction` | |\n| `sessiontoken` | `sessionToken` | |\n| `types` | `includedPrimaryTypes` | |\n\nExample request\n---------------\n\nThe following example GET request uses Place Autocomplete (Legacy). In this\nexample, you request a JSON response containing information about places called\n\"Amoeba\" that are of type `establishment` and pass all parameters as URL\nparameters: \n\n```curl\ncurl -L -X GET 'https://maps.googleapis.com/maps/api/place/autocomplete/json?input=amoeba&types=establishment&location=37.76999%2C-122.44696&radius=500&key=YOUR_API_KEY'\n```\n\nWith Autocomplete (New), you make a POST request and pass all parameters\nin the JSON request body or in headers as part of the POST request.\n\nField masks are not required for Autocomplete (New) requests, but they can\nbe used to filter for specific results in the response. For example, the\nfollowing request uses a field mask so the response only includes the\n`suggestions.placePrediction.text` of the suggestion: \n\n```curl\ncurl -X POST -d '{\n \"input\": \"Amoeba\",\n \"locationBias\": {\n \"circle\": {\n \"center\": {\n \"latitude\": 37.76999,\n \"longitude\": -122.44696\n },\n \"radius\": 500.0\n }\n }\n}' \\\n-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \\\n-H 'X-Goog-FieldMask: suggestions.placePrediction.text' \\\nhttps://places.googleapis.com/v1/places:autocomplete\n```\n\nTo learn more about using field masks, see\n[Place Details (New)](/maps/documentation/places/web-service/place-details#fieldmask)."]]
