Varış noktası arama

Avrupa Ekonomik Alanı'ndaki (AEA) geliştiriciler

Destination, kullanıcının ulaşmak veya gitmek istediği belirli bir konumu ya da yeri ifade eder. Destination, konum veya yerle ilgili navigasyon noktaları, önemli yerler, girişler ve bina ana hatları gibi bilgileri de içerir.

Geocoding API'nin SearchDestinations yöntemi, adres, yer kimliği veya enlem ve boylam koordinatları gibi farklı giriş ölçütlerine göre çeşitli hedefler hakkında ayrıntılı bilgi almanızı sağlar.

Hedef arama isteği

Varış noktası arama isteği, şu biçimdeki bir URL'ye gönderilen HTTP POST isteğidir:

https://geocode.googleapis.com/v4/geocode/destinations

POST isteğinin bir parçası olarak JSON istek gövdesindeki veya üstbilgilerdeki tüm parametreleri iletin. Örneğin:

curl -X POST -d '{
  "place": "places/ChIJY8sv5-i2j4AR_S6BlDDR42w"
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: *" \
https://geocode.googleapis.com/v4/geocode/destinations

Varış noktası aramak için konumu 3 şekilde belirtebilirsiniz:

  • Adres
  • Yer kimliği
  • Enlem ve boylam koordinatları

Adrese göre hedef arama

Adresi yapılandırılmamış bir dize olarak belirtebilirsiniz. Adres coğrafi kodlaması, enlem ve boylam koordinatlarını veya bir adresi temsil etmeyen diğer yapılandırılmamış dizeleri çözmez. Bu tür dizelerin kullanıldığı istekler desteklenmez ve hata yanıtlarına veya belirtilmemiş davranışlara yol açabilir. Desteklenmeyen sorgulara örnek olarak aşağıdakiler verilebilir:

Sorgu türü Örnek
Enlem ve boylam koordinatları. Bunun yerine konum sorgusu kullanın. "37.422131,-122.084801"
Tek bir sorguda birden fazla yer, yol veya şehir adı gibi çok fazla kavram ya da kısıtlama "Market Street San Francisco San Jose Airport"
Google Haritalar'da gösterilmeyen posta adresi öğeleri "C/O John Smith 123 Main Street"
"P.O. Box 13 San Francisco"
İşletmelerin, zincirlerin veya kategorilerin, bu öğelerin bulunmadığı konumlarla birlikte kullanıldığı adlar "Dallas, Teksas yakınlarındaki Tesco"
Birden fazla yorumu olan belirsiz sorgular "Şarj cihazı bırakma"
Artık kullanılmayan eski adlar "Middlesex Birleşik Krallık"
Coğrafi olmayan öğeler veya amaç "Ventura Limanı'nda kaç tekne var?"
Resmi olmayan veya özel adlar "The Jenga"
"The Helter Skelter"
Büyük siyasi varlıklar (şehirler, eyaletler, ülkeler) "New York City"
"California"
"USA"
Belirli adresleri olmayan rotalar "1st Ave., NYC, NY"
"I-95" 
curl -X POST -d '{
  "addressQuery": {
    "addressQuery": "601 S Bernardo Ave, Sunnyvale, CA 94087, USA"
  }
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: *" \
https://geocode.googleapis.com/v4/geocode/destinations

veya postalAddress olarak:

curl -X POST -d '{
  "addressQuery": {
    "address": {
      "addressLines": ["601 S Bernardo Ave"],
      "locality": "Sunnyvale",
      "postalCode": "94087",
      "administrativeArea": "CA",
      "regionCode": "US"
    }
  }
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: *" \
https://geocode.googleapis.com/v4/geocode/destinations

Genellikle bir HTML formunda yakalanan adres bileşenlerini işlerken postalAddress biçimini kullanırsınız.

Yer kimliğine göre hedef arama

Yer kimliği sağlayarak bir hedefi alabilirsiniz:

curl -X POST -d '{
  "place": "places/ChIJY8sv5-i2j4AR_S6BlDDR42w"
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: *" \
https://geocode.googleapis.com/v4/geocode/destinations

Desteklenen yer kimlikleri

Search Destinations yöntemi, belirli ve gidilebilir varış noktalarını temsil eden yer kimlikleriyle en iyi şekilde çalışır. establishment, point_of_interest, premise, street_address ve subpremise gibi türler için yer kimlikleri genellikle desteklenir. Ayrı konumları temsil etmeyen yer kimlikleri (ör. adres aralıklarından çıkarılanlar ["10-20 Main St" gibi]), belirli bir numarası olmayan rota bölümleri veya Plus Kodlar desteklenmez. Alanı çok büyük olan sonuçlar (ör. "Pasifik Okyanusu") için yer kimlikleri de desteklenmez.

Arama hedefleriyle otomatik tamamlama (yeni) özelliğini kullanma

Uyumluluğu sağlamak için Autocomplete (New) özelliğini kullanarak Search Destinations ile kullanılacak yer kimliklerini bulun. Autocomplete (New) özelliğini kullanırken sonuçları türe göre filtrelemek için includedPrimaryTypes parametresini kullanmanız gerekir. Aşağıdaki önerilen filtre kullanılarak Autocomplete (New) tarafından döndürülen yer kimlikleri, Search Destinations tarafından desteklenir:

"includedPrimaryTypes": [ "establishment", "point_of_interest", "premise", "street_address", "subpremise" ]

Ayrıca, Autocomplete (New) isteğinizde include_pure_service_area_businesses işaretini true olarak ayarlamamanız gerekir.

Konuma göre hedef arama

Enlem ve boylam koordinatlarını girerek bir hedef arayabilirsiniz:

curl -X POST -d '{
  "locationQuery": {
    "location": {
      "latitude": 37.37348780,
      "longitude": -122.05678064
    }
  }
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: *" \
https://geocode.googleapis.com/v4/geocode/destinations

İstekte bulunmak için OAuth'u kullanma

Geocoding API v4, kimlik doğrulama için OAuth 2.0'ı destekler. Geocoding API ile OAuth kullanmak için OAuth jetonuna doğru kapsam atanmalıdır. Geocoding API, Destinations yöntemiyle kullanılmak üzere aşağıdaki kapsamları destekler:

  • https://www.googleapis.com/auth/maps-platform.geocode — Tüm Geocoding API yöntemleriyle kullanılabilir.

Ayrıca, tüm Geocoding API yöntemleri için genel https://www.googleapis.com/auth/cloud-platform kapsamını kullanabilirsiniz. Bu kapsam, tüm yöntemlere erişime izin veren genel bir kapsam olduğundan geliştirme sırasında kullanışlıdır ancak üretimde kullanışlı değildir.

Daha fazla bilgi ve örnek için OAuth'u kullanma başlıklı makaleyi inceleyin.

Arama hedefleri yanıtı

Arama Hedefleri yanıtı, konum hakkında zengin ve yakın çevreye özel bağlam bilgisi sağlar.

Search Destinations yanıtındaki PlaceView nesneleri (ör. primary, containingPlaces içindeki öğeler ve landmarks), yer türünü belirtmek için alanları kullanır:

  • types: Yerin türlerini belirten dize dizisi.
  • primaryType: Yerleşim yerinin birincil türünü belirten dize.

Hem types hem de primaryType için olası dize değerleri, Yer Türleri (Yeni) sayfasındaki Tablo A ve Tablo B'den alınır.

Bu bölümde, temel yanıt alanları açıklanmaktadır. Tüm yanıt alanlarıyla ilgili ayrıntılı bilgi için API Referansı'na bakın.

primary

İstekteki sorgu tarafından tanımlanan ana yer.

addressComponents

Bu adres için geçerli olan ayrı bileşenleri içeren bir dizi.

Her adres bileşeni genellikle aşağıdaki alanları içerir:

  • types[], adres bileşeninin türünü belirten bir dizidir. Desteklenen türlerin listesine bakın.
  • longText, adres bileşeninin Geocoder tarafından döndürülen tam metin açıklaması veya adıdır.
  • shortText, varsa adres bileşeninin kısaltılmış metin adıdır. Örneğin, Alaska eyaleti için bir adres bileşeninin longText değeri "Alaska" ve shortText değeri, iki harfli posta kısaltması kullanılarak "AK" olabilir.
  • languageCode, bu bileşeni biçimlendirmek için kullanılan dildir (CLDR gösteriminde).

containingPlaces

Birincil hedefin parçası olduğu daha büyük öğeler (örneğin, bir mağazanın bulunduğu alışveriş merkezi).

subDestinations

Birincil hedefteki daha ayrıntılı konumlar (örneğin, bir binadaki daireler).

entrances

entrances[] dizisindeki nesneler aşağıdaki alanlara sahiptir:

  • location

    Bir giriş ve çıkış noktasının konumunu tanımlayan tek bir enlem/boylam koordinat çifti.

  • entrance_tags[]

    Girişin özelliklerini açıklayan bir giriş etiketi dizisi. Aşağıdaki değer desteklenir:

    • "PREFERRED"

    Bu girişin, döndürülen yere fiziksel erişim sağlama olasılığının yüksek olduğunu gösterir. Bir yerin birden fazla tercih edilen girişi olabilir. Bir giriş bu etikete sahip değilse giriş fiziksel olarak aynı binada yer alıyor ancak yere erişim sağlamıyor demektir.

    Örneğin, döndürülen yer bir alışveriş merkezindeki bir restoransa "PREFERRED" girişleri, restoranın kendi girişleri olur. Döndürülen diğer girişler ise binanın diğer girişleri (ör. alışveriş merkezindeki diğer restoranların girişleri) olur.

    Döndürülen yerin kendisi bir binaysa "PREFERRED" girişler, binanın "ana" kısmına giden girişler olur. Örneğin, bir alışveriş merkezinde "PREFERRED" girişleri, ana fuaye alanına erişime izin veren girişlerdir. Ancak bir giriş yalnızca binanın yan tarafındaki bir mağazaya erişim sağlıyorsa bu giriş "PREFERRED" girişi olmaz.

  • streetViewThumbnail ve streetViewAnnotation

    Street View Static API için parametreler, bu konumlarla ilgili görüntüleri göstermenize olanak tanır. Bu alanlar hakkında daha fazla bilgi edinin.

structureType

Bu yerin temsil ettiği yapı türü.

  • POINT

    Bir nokta konumu.

  • SECTION

    Bir binanın alt bölümü.

  • BUILDING

    Bir bina.

  • GROUNDS

    Genellikle üniversite kampüsü, apartman kompleksi veya alışveriş merkezi gibi birden fazla binanın bulunduğu geniş bir alan.

Coğrafi kodlama yanıtındaki navigationPoints alanı, yere gitmek için yararlı olan noktaların listesini içerir. Özellikle, bir yol ağında bir yerden veya bir yere rota oluştururken başlangıç ya da bitiş noktası olarak kullanılmalıdır.

Her gezinme noktası aşağıdaki değerleri içerir:

  • navigationPointToken, navigationPoints alanındaki bağlamsal bilgileri içeren bir jetondur. Uygulamanızdaki rota ve nehir deneyimini iyileştirmek için bu jetonu rota ve navigasyon API'lerine gönderebilirsiniz. Daha fazla bilgi için Navigasyon noktası jetonlarını kullanarak rota oluşturma başlıklı makaleyi inceleyin.
  • location, navigasyon noktasının enlem ve boylam değerini içerir. Bu konum her zaman yol ağına çok yakındır ve bir yere gidip gelmek için ideal bir durma veya başlangıç noktasını temsil eder. Nokta, yerin bulunduğu yolun tarafını net bir şekilde işaretlemek için kasıtlı olarak yolun merkez çizgisinden biraz uzağa yerleştirilir.
  • travelModes, gezinme noktasına erişilebilen seyahat modlarının listesidir:
    • "DRIVE", arabayla yol tariflerine karşılık gelen seyahat modudur.
    • "WALK", yaya yol tarifine karşılık gelen seyahat modudur.
  • usages, gezinme noktası tarafından desteklenen kullanımların listesidir. Kullanımlar:
    • "DROPOFF"
    • "PICKUP"
    • "PARKING"

Teslim alma ve bırakma işlemleri için seyahat modunun DRIVE, kullanımın ise PICKUP veya DROPOFF olduğu navigasyon noktasını kullanın. Teslim alma veya bırakma noktaları yoksa en üstteki sürüş navigasyon noktasını kullanın.

  • altitude_meters, WGS-84 elipsoidine göre navigasyon noktasının metre cinsinden yüksekliğini içerir. Dikey olarak üst üste binen yol segmentlerinin olduğu durumlarda, sisteminizin gitmesi gereken en iyi yol segmentini seçmek için altitude_meters alanını kullanın.

landmarks

Kullanıcıların varış noktasının çevresini anlamasına yardımcı olacak, yakındaki önemli yerler.

arrivalSummary

Varış konusunda yardımcı olacak yapay zeka destekli analizler. Yapay zeka destekli özetleri inceleyin.

parkingOptions

Ayrıntılı otopark bilgileri.

Yanıt biçimi

SearchDestinations, aşağıdaki JSON formunun SearchDestinationsResponse değerini döndürür:

{
  "destinations": [
    {
      "primary": {
        "place": "places/ChIJY8sv5-i2j4AR_S6BlDDR42w",
        "displayName": {
          "text": "Arby's",
          "languageCode": "en"
        },
        "primaryType": "fast_food_restaurant",
        "types": [
          "fast_food_restaurant",
          "sandwich_shop",
          "deli",
          "meal_takeaway",
          "food_delivery",
          "american_restaurant",
          "restaurant",
          "food_store",
          "store",
          "food",
          "point_of_interest",
          "establishment"
        ],
        "formattedAddress": "Arby's, 601 S Bernardo Ave, Sunnyvale, CA 94087, USA",
        "postalAddress": {
          "regionCode": "US",
          "languageCode": "en",
          "postalCode": "94087",
          "administrativeArea": "CA",
          "locality": "Sunnyvale",
          "addressLines": [
            "601 S Bernardo Ave"
          ]
        },
        "structureType": "BUILDING",
        "location": {
          "latitude": 37.3734545,
          "longitude": -122.05693269999998
        },
        "displayPolygon": {
          "type": "Polygon",
          "coordinates": [
            [
              [
                -122.056930138027,
                37.3735253692531
              ],
              [
                -122.056960139391,
                37.3735372663597
              ],
              [
                -122.056994129366,
                37.3734828786847
              ],
              [
                -122.056969677395,
                37.3734731161089
              ],
              [
                -122.057061762447,
                37.3733261309656
              ],
              [
                -122.056979388817,
                37.3732935577128
              ],
              [
                -122.056798860285,
                37.3735818838642
              ],
              [
                -122.056875858081,
                37.3736121235316
              ],
              [
                -122.056930138027,
                37.3735253692531
              ]
            ]
          ]
        }
      },
      "containingPlaces": [
        {
          "place": "places/ChIJYfdAFum2j4ARIcL2tjME3Sw",
          "displayName": {
            "text": "Cherry Chase Shopping Center",
            "languageCode": "en"
          },
          "primaryType": "shopping_mall",
          "types": [
            "shopping_mall",
            "point_of_interest",
            "establishment"
          ],
          "formattedAddress": "Cherry Chase Shopping Center, 663 S Bernardo Ave, Sunnyvale, CA 94087, USA",
          "postalAddress": {
            "regionCode": "US",
            "languageCode": "en",
            "postalCode": "94087-1020",
            "administrativeArea": "CA",
            "locality": "Sunnyvale",
            "addressLines": [
              "663 S Bernardo Ave"
            ]
          },
          "structureType": "GROUNDS",
          "location": {
            "latitude": 37.3731231,
            "longitude": -122.0578211
          },
          "displayPolygon": {
            "type": "Polygon",
            "coordinates": [
              [
                [
                  -122.057112227103,
                  37.3714618008523
                ],
                [
                  -122.057076849821,
                  37.3715743611411
                ],
                [
                  -122.056963607756,
                  37.3719081793948
                ],
                [
                  -122.056865279559,
                  37.3722026053835
                ],
                [
                  -122.056687872374,
                  37.3727258358476
                ],
                [
                  -122.056580005889,
                  37.3730511370747
                ],
                [
                  -122.056498845827,
                  37.3732994782583
                ],
                [
                  -122.056338259713,
                  37.3737878663325
                ],
                [
                  -122.056618678291,
                  37.373887693582
                ],
                [
                  -122.056912102521,
                  37.3740010327191
                ],
                [
                  -122.057532418159,
                  37.3742476426462
                ],
                [
                  -122.057673926626,
                  37.3742441740031
                ],
                [
                  -122.057735663106,
                  37.3742328516943
                ],
                [
                  -122.057766531332,
                  37.3742220604378
                ],
                [
                  -122.057797572967,
                  37.37420520725
                ],
                [
                  -122.057828267759,
                  37.3741852342085
                ],
                [
                  -122.058060299297,
                  37.3740060842535
                ],
                [
                  -122.058199726081,
                  37.3737861673422
                ],
                [
                  -122.05836707267,
                  37.373524542556
                ],
                [
                  -122.058569622393,
                  37.3732018598683
                ],
                [
                  -122.0587638478,
                  37.3728890198039
                ],
                [
                  -122.058934661823,
                  37.3726036257774
                ],
                [
                  -122.059164956851,
                  37.3722498383629
                ],
                [
                  -122.058997784906,
                  37.3721804442035
                ],
                [
                  -122.057936479838,
                  37.3717605636234
                ],
                [
                  -122.057495827092,
                  37.3715860151634
                ],
                [
                  -122.057112227103,
                  37.3714618008523
                ]
              ]
            ]
          }
        }
      ],
      "landmarks": [
        {
          "place": {
            "place": "places/ChIJXXTe7Oi2j4ARoMTA-D6Hjpg",
            "displayName": {
              "text": "Chase Bank",
              "languageCode": "en"
            },
            "primaryType": "bank",
            "types": [
              "bank",
              "atm",
              "finance",
              "point_of_interest",
              "establishment"
            ],
            "formattedAddress": "Chase Bank, 1234 W El Camino Real, Sunnyvale, CA 94087, USA",
            "postalAddress": {
              "regionCode": "US",
              "languageCode": "en",
              "postalCode": "94087",
              "administrativeArea": "CA",
              "locality": "Sunnyvale",
              "addressLines": [
                "1234 W El Camino Real"
              ]
            },
            "structureType": "POINT",
            "location": {
              "latitude": 37.373579,
              "longitude": -122.05752700000001
            }
          },
          "relationalDescription": {
            "text": "Near Chase Bank",
            "languageCode": "en"
          },
          "tags": [
            "ARRIVAL",
            "ADDRESS"
          ],
          "straightLineDistanceMeters": 61.182193756103516,
          "travelDistanceMeters": 63.075645446777344
        },
        {
          "place": {
            "place": "places/ChIJteQ0Fum2j4ARGi3tqK4Zm14",
            "displayName": {
              "text": "Safeway",
              "languageCode": "en"
            },
            "primaryType": "grocery_store",
            "types": [
              "grocery_store",
              "butcher_shop",
              "florist",
              "deli",
              "supermarket",
              "bakery",
              "food_delivery",
              "market",
              "manufacturer",
              "food_store",
              "store",
              "food",
              "service",
              "point_of_interest",
              "establishment"
            ],
            "formattedAddress": "Safeway, 639 S Bernardo Ave, Sunnyvale, CA 94087, USA",
            "postalAddress": {
              "regionCode": "US",
              "languageCode": "en",
              "postalCode": "94087",
              "administrativeArea": "CA",
              "locality": "Sunnyvale",
              "addressLines": [
                "639 S Bernardo Ave"
              ]
            },
            "structureType": "POINT",
            "location": {
              "latitude": 37.3727912,
              "longitude": -122.0581172
            }
          },
          "relationalDescription": {
            "text": "Around the corner from Safeway",
            "languageCode": "en"
          },
          "tags": [
            "ARRIVAL",
            "ADDRESS"
          ],
          "straightLineDistanceMeters": 158.65606689453125,
          "travelDistanceMeters": 131.1669921875
        },
        {
          "place": {
            "place": "places/ChIJu-PSYui2j4ARNiwOwBApGqk",
            "displayName": {
              "text": "Oil Changers",
              "languageCode": "en"
            },
            "types": [
              "car_repair",
              "service",
              "point_of_interest",
              "establishment"
            ],
            "formattedAddress": "Oil Changers, 1240 W El Camino Real, Sunnyvale, CA 94087, USA",
            "postalAddress": {
              "regionCode": "US",
              "languageCode": "en",
              "postalCode": "94087",
              "administrativeArea": "CA",
              "locality": "Sunnyvale",
              "addressLines": [
                "1240 W El Camino Real"
              ]
            },
            "structureType": "POINT",
            "location": {
              "latitude": 37.3743054,
              "longitude": -122.0584272
            }
          },
          "relationalDescription": {
            "text": "Down the road from Oil Changers",
            "languageCode": "en"
          },
          "tags": [
            "ARRIVAL"
          ],
          "straightLineDistanceMeters": 140.52459716796875,
          "travelDistanceMeters": 143.24220275878906
        },
        {
          "place": {
            "place": "places/ChIJKRbl5oG3j4ARwuvPGUmtCj0",
            "displayName": {
              "text": "Apni Mandi Farmers Market Sunnyvale",
              "languageCode": "en"
            },
            "primaryType": "grocery_store",
            "types": [
              "grocery_store",
              "cake_shop",
              "supermarket",
              "asian_grocery_store",
              "indian_restaurant",
              "meal_takeaway",
              "bakery",
              "manufacturer",
              "wholesaler",
              "restaurant",
              "food_store",
              "store",
              "food",
              "point_of_interest",
              "establishment"
            ],
            "formattedAddress": "Apni Mandi Farmers Market Sunnyvale, 1111 W El Camino Real, Sunnyvale, CA 94087, USA",
            "postalAddress": {
              "regionCode": "US",
              "languageCode": "en",
              "postalCode": "94087-1056",
              "administrativeArea": "CA",
              "locality": "Sunnyvale",
              "addressLines": [
                "1111 W El Camino Real"
              ]
            },
            "structureType": "POINT",
            "location": {
              "latitude": 37.3737199,
              "longitude": -122.0522958
            }
          },
          "relationalDescription": {
            "text": "Near Apni Mandi Farmers Market Sunnyvale",
            "languageCode": "en"
          },
          "tags": [
            "ADDRESS"
          ],
          "straightLineDistanceMeters": 410.37435913085938,
          "travelDistanceMeters": 479.49893188476562
        },
        {
          "place": {
            "place": "places/ChIJ8enMlui2j4AR2xXK5EHDhBs",
            "displayName": {
              "text": "Starbird Chicken",
              "languageCode": "en"
            },
            "primaryType": "chicken_restaurant",
            "types": [
              "chicken_restaurant",
              "fast_food_restaurant",
              "restaurant",
              "food",
              "point_of_interest",
              "establishment"
            ],
            "formattedAddress": "Starbird Chicken, 1241 W El Camino Real, Sunnyvale, CA 94087, USA",
            "postalAddress": {
              "regionCode": "US",
              "languageCode": "en",
              "postalCode": "94087-1028",
              "administrativeArea": "CA",
              "locality": "Sunnyvale",
              "addressLines": [
                "1241 W El Camino Real"
              ]
            },
            "structureType": "BUILDING",
            "location": {
              "latitude": 37.3746764,
              "longitude": -122.05708860000001
            },
            "displayPolygon": {
              "coordinates": [
                [
                  [
                    -122.057003840785,
                    37.3747648209809
                  ],
                  [
                    -122.057136852459,
                    37.3747919153144
                  ],
                  [
                    -122.057205005705,
                    37.3745815131859
                  ],
                  [
                    -122.057071994114,
                    37.3745544186944
                  ],
                  [
                    -122.057003840785,
                    37.3747648209809
                  ]
                ]
              ],
              "type": "Polygon"
            }
          },
          "relationalDescription": {
            "text": "Near Starbird Chicken",
            "languageCode": "en"
          },
          "tags": [
            "ADDRESS"
          ],
          "straightLineDistanceMeters": 87.348007202148438,
          "travelDistanceMeters": 214.08084106445312
        }
      ],
      "entrances": [
        {
          "location": {
            "latitude": 37.3735328,
            "longitude": -122.05694879999999
          },
          "tags": [
            "PREFERRED"
          ],
          "place": "places/ChIJY8sv5-i2j4AR_S6BlDDR42w"
        }
      ],
      "navigationPoints": [
        {
          "navigationPointToken": "ChIJeMt61tqvQkARWT2716SDXsASEgljyy_n6LaPgBH9LoGUMNHjbBoSCWPLL-foto-AEf0ugZQw0eNsIhIJhf5y6ei2j4ARz7yBW5KAPI4",
          "location": {
            "latitude": 37.3738659,
            "longitude": -122.05693620000001
          },
          "travelModes": [
            "DRIVE",
            "WALK"
          ],
          "usages": [
            "PARKING"
          ]
        }
      ]
    }
  ]
}

Gerekli parametreler

  • API isteğinde, varış noktası aramak için adresi, yeri veya konumu belirten aşağıdaki 3 parametreden biri bulunmalıdır:
    • addressQuery: Aranacak adres.
    • place: Aranacak yerin yer kimliği.
    • locationQuery: Aranacak konumun enlem ve boylam koordinatları.

  • FieldMask

    Bir yanıt alanı maskesi oluşturarak yanıtta döndürülecek alanların listesini belirtin. $fields veya fields URL parametresini ya da X-Goog-FieldMask HTTP üst bilgisini kullanarak yanıt alanı maskesini yönteme iletin. Örneğin, aşağıdaki istek yalnızca birincil hedefin girişlerini, gezinme noktalarını ve yer kimliğini döndürür.

      curl -X POST -d '{"place": "places/ChIJG3kh4hq6j4AR_XuFQnV0_t8"}' \
    -H "X-Goog-Api-Key: API_KEY" \
    -H "Content-Type: application/json" \
    -H "X-Goog-FieldMask: destinations.entrances,destinations.navigationPoints,destinations.primary.place" \
    https://geocode.googleapis.com/v4/geocode/destinations

    Yanıtta döndürülen alanların varsayılan bir listesi yoktur. Alan maskesini atlarsanız yöntem hata döndürür. Tüm alanları döndürmek için alan maskesini * olarak ayarlayın. Daha fazla bilgi için Döndürülecek alanları seçme bölümünü inceleyin.

İsteğe bağlı parametreler

  • travelModes

    Hangi navigationPoints türlerinin döndürüleceğini belirtir. Diğer seyahat modlarına ait gezinme noktaları filtrelenir. travelModes ayarlanmazsa tüm seyahat modlarının navigasyon noktaları döndürülebilir.

  • languageCode

    Sonuçların döndürüleceği dil.

    • Desteklenen dillerin listesini inceleyin. Google, desteklenen dilleri sık sık güncellediğinden bu liste kapsamlı olmayabilir.
    • languageCode sağlanmazsa API, varsayılan olarak konumun yerel dilini ve alfabesini kullanır. Geçersiz bir dil kodu belirtirseniz API, INVALID_ARGUMENT hatası döndürür.
    • API, hem kullanıcı hem de yerel halk tarafından okunabilir bir açık adres sağlamak için elinden geleni yapar. Bu hedefi gerçekleştirmek için tercih edilen dili dikkate alarak yerel dildeki sokak adreslerini döndürür. Gerekirse bu adresler, kullanıcı tarafından okunabilir bir alfabeye çevrilir. Diğer tüm adresler tercih edilen dilde döndürülür. Adres bileşenlerinin tümü, ilk bileşenden seçilen dilde döndürülür.
    • Tercih edilen dilde bir ad yoksa API en yakın eşleşmeyi kullanır.
    • Tercih edilen dil, API'nin döndürmeyi seçtiği sonuç kümesi ve bu sonuçların döndürülme sırası üzerinde küçük bir etkiye sahiptir. Coğrafi kodlayıcı, kısaltmaları dile göre farklı şekilde yorumlar. Örneğin, sokak türlerinin kısaltmaları veya bir dilde geçerli olup başka bir dilde geçerli olmayan eş anlamlı kelimeler buna dahildir.

  • regionCode

    İki karakterli CLDR kodu değeri olarak bölge kodu. Varsayılan değer yoktur. Çoğu CLDR kodu, ISO 3166-1 kodlarıyla aynıdır.

    Bir adresin coğrafi kodlaması yapılırken (ileri coğrafi kodlama) bu parametre, hizmetten gelen sonuçları belirtilen bölgeyle sınırlayabilir ancak tamamen kısıtlayamaz. Bir konumun veya yerin coğrafi kodlaması, tersine coğrafi kodlama ya da yer coğrafi kodlaması yapılırken bu parametre, adresi biçimlendirmek için kullanılabilir. Bu parametre, geçerli yasaya göre sonuçları her durumda etkileyebilir.

  • placeFilter

    Bir locationQuery aramasının sonuçlarını, yalnızca bina olan varış noktalarını veya yalnızca açık adresleri olan varış noktalarını döndürmek gibi gereksinimlerinizi karşılayacak şekilde filtrelemenize olanak tanır.

    Yapısal ayrıntı düzeyine göre filtreleme

    structureType filtresi, sorgu tarafından döndürülen yapı türlerini belirtmenize olanak tanır:

    • Binaları Ayırma: Haritada bina ana hatlarını göstermek veya belirli bir yapı hakkında ayrıntılı bilgi edinmek için "structureType": "BUILDING" simgesini kullanın.
    • Kompleksleri anlama: Birincil sonucun tüm tesis olmasını sağlamak için "structureType": "GROUNDS" kullanın. Bu, üniversite kampüsleri veya alışveriş merkezleri gibi daha büyük alanları sorgularken kullanışlıdır.
    • Birimlere/bölümlere odaklanma: Bir binadaki bölümleri tanımlamak için "structureType": "SECTION" kullanın.

    Faydalı adresler sağlama

    Bazı yerlerin açık adresleri yoktur. addressability filtresi, sonuçlarınızdaki adreslerin kalitesini kontrol etmenize yardımcı olur:

    • Net Birincil Adres Gerektir: Ana hedef sonucunun her zaman sokak düzeyinde bir adresi veya adı olmasını sağlamak için "addressability": "PRIMARY" kullanın. Bu, net bir adresin çok önemli olduğu gezinme veya görüntüleme amaçları için kullanışlıdır.
    • Alt Hedeflerdeki Adreslere İzin Ver: Birincil yerin adresi olmayabileceği ancak içindeki birimlerin (ör. bir binadaki daireler) adresi olabileceği durumlarda "addressability": "WEAK", en azından birincil yerin veya alt hedeflerinden birinin adresi olmasını sağlar.
    • Herhangi bir sonuç: Adres varlığı kullanım alanınızla alakalı değilse "addressability": "ANY" kullanın. Bu yöntem, yalnızca bina ana hatları ve gezinme noktaları gibi geometrik özelliklere ihtiyacınız olduğunda kesinlikle önerilir. Bu sonuçların doğruluğunu artırır.
    Örnek: Adreslenebilir binalar için filtreleme 
    curl -X POST -d '{
  "locationQuery": {
    "location": {
      "latitude": 37.37348780,
      "longitude": -122.05678064
    },
    "placeFilter": {
      "structureType": "BUILDING",
      "addressability": "PRIMARY"
    }
  },
  "languageCode": "en"
}' \\
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \\
-H "X-Goog-FieldMask: place" \\
https://geocode.googleapis.com/v4/geocode/destinations